From 4a72cab818713659c53006e28c5e7e1837c50bba Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 3 May 2018 22:04:28 -0400 Subject: [PATCH] Document gdk_drop_read_async --- gdk/gdkdnd.c | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c index 545e7cb3ca..ae90dbdd96 100644 --- a/gdk/gdkdnd.c +++ b/gdk/gdkdnd.c @@ -692,11 +692,14 @@ gdk_drag_context_write_finish (GdkDragContext *context, /** * gdk_drop_read_async: * @context: a #GdkDragContext - * @mime_types: (array zero-terminated=1) (element-type utf8): - * @io_priority: - * @cancellable: - * @callback: - * @user_data: (closure): + * @mime_types: (array zero-terminated=1) (element-type utf8): pointer to an array of mime types + * @io_priority: the io priority for the read operation + * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied + * @user_data: (closure): the data to pass to @callback + * + * Asynchronously read the dropped data from a DND context + * in a format that complies with one of the mime types. */ void gdk_drop_read_async (GdkDragContext *context, @@ -728,9 +731,11 @@ gdk_drop_read_async (GdkDragContext *context, /** * gdk_drop_read_finish: * @context: a #GdkDragContext - * @out_mime_type: (out) (type utf8): - * @result: - * @error: + * @out_mime_type: (out) (type utf8): return location for the used mime type + * @result: a #GAsyncResult + * @error: (allow-none): location to store error information on failure, or %NULL + * + * Finishes an async drop read operation, see gdk_drop_read_async(). * * Returns: (nullable) (transfer full): the #GInputStream, or %NULL */ -- 2.30.2